home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 June / SGI Freeware 1998 June.iso / dist / fw_bind.idb / usr / freeware / catman / u_man / cat1 / dnsquery.1.z / dnsquery.1
Text File  |  1998-05-26  |  5KB  |  98 lines
  1. DNSQUERY(1)                  BSD Reference Manual                  DNSQUERY(1)
  2.  
  3. NNAAMMEE
  4.      ddnnssqquueerryy - query domain name servers using resolver
  5.  
  6. SSYYNNOOPPSSIISS
  7.      ddnnssqquueerryy [--nn _n_a_m_e_s_e_r_v_e_r] [--tt _t_y_p_e] [--cc _c_l_a_s_s] [--rr _r_e_t_r_y] [--pp _p_e_r_i_o_d] [--dd]
  8.               [--ss] [--vv] _h_o_s_t
  9.  
  10. DDEESSCCRRIIPPTTIIOONN
  11.      The ddnnssqquueerryy program is a general interface to nameservers via BIND re-
  12.      solver library calls.  The program supports queries to the nameserver
  13.      with an opcode of QUERY.  This program is intended to be a replacement or
  14.      supplement to programs like nstest, nsquery and nslookup.  All arguments
  15.      except for _h_o_s_t and _n_a_m_e_s_e_r_v_e_r are treated without case-sensitivity.
  16.  
  17. OOPPTTIIOONNSS
  18.      --nn _n_a_m_e_s_e_r_v_e_r
  19.                  The nameserver to be used in the query.  Nameservers can ap-
  20.                  pear as either Internet addresses of the form _w_._x_._y_._z or can
  21.                  appear as domain names.  (Default: as specified in
  22.                  _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f.)
  23.  
  24.      --tt _t_y_p_e     The type of resource record of interest.  Types include:
  25.                        _A        address
  26.                        _N_S       nameserver
  27.                        _C_N_A_M_E    canonical name
  28.                        _P_T_R      domain name pointer
  29.                        _S_O_A      start of authority
  30.                        _W_K_S      well-known service
  31.                        _H_I_N_F_O    host information
  32.                        _M_I_N_F_O    mailbox information
  33.                        _M_X       mail exchange
  34.                        _R_P       responsible person
  35.                        _M_G       mail group member
  36.                        _A_F_S_D_B
  37.                                 DCE or AFS server
  38.                        _A_N_Y      wildcard
  39.  
  40.                  Note that any case may be used.  (Default: _A_N_Y.)
  41.  
  42.      --cc _c_l_a_s_s    The class of resource records of interest.  Classes include:
  43.                        _I_N       Internet
  44.                        _H_S       Hesiod
  45.                        _C_H_A_O_S    Chaos
  46.                        _A_N_Y      wildcard
  47.  
  48.                  Note that any case may be used.  (Default: _I_N.)
  49.  
  50.      --rr _r_e_t_r_y    The number of times to retry if the nameserver is not re-
  51.                  sponding.  (Default:  4.)
  52.  
  53.      --pp _p_e_r_i_o_d   Period to wait before timing out.  (Default: RES_TIMEOUT.)
  54.  
  55.      --dd          Turn on debugging.  This sets the RES_DEBUG bit of the re-
  56.                  solver's _o_p_t_i_o_n_s field.  (Default:  no debugging.)
  57.  
  58.      --ss          Use a _s_t_r_e_a_m rather than a packet.  This uses a TCP stream
  59.                  connection with the nameserver rather than a UDP datagram.
  60.                  This sets the RES_USEVC bit of the resolver's _o_p_t_i_o_n_s field.
  61.                  (Default:  UDP datagram.)
  62.  
  63.      --vv          Synonym for the ``--ss'' flag.
  64.  
  65.      _h_o_s_t        The name of the host (or domain) of interest.
  66.  
  67. FFIILLEESS
  68.      /etc/resolv.conf    to get the default ns and search lists
  69.      <arpa/nameser.h>
  70.                          list of usable RR types and classes
  71.      <resolv.h>
  72.                          list of resolver flags
  73.  
  74. DDIIAAGGNNOOSSTTIICCSS
  75.      If the resolver fails to answer the query and debugging has not been
  76.      turned on, ddnnssqquueerryy will simply print a message like:
  77.            Query failed (rc = 1): Unknown host
  78.  
  79.      The value of the return code is supplied by _h___e_r_r_n_o _.
  80.  
  81. SSEEEE AALLSSOO
  82.      nslookup(8),  nstest(1),  nsquery(1),  named(8),  resolver(5).
  83.  
  84. AAUUTTHHOORR
  85.      Bryan Beecher
  86.  
  87. BBUUGGSS
  88.      Queries of a class other than _I_N can have interesting results since ordi-
  89.      narily a nameserver only has a list of root nameservers for class _I_N re-
  90.      source records.
  91.  
  92.      DDnnssqquueerryy uses a call to iinneett__aaddddrr() to determine if the argument for the
  93.      ``--nn'' option is a valid Internet address.  Unfortunately, iinneett__aaddddrr()
  94.      seems to cause a segmentation fault with some (bad) IP addresses (e.g.,
  95.      1.2.3.4.5).
  96.  
  97. 4th Berkeley Distribution       March 10, 1990                               2
  98.